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CHAPTER  1 


Introduction  to  the  Text  Formatting  System 


The  Text  Formatting  System,  hereafter  referred  to  as  TFS,  is  a  program 
which  produces  a  modified  printer  listing  of  the  contents  of  a  CP/M  text  file. 
This  listing  is  formatted;  that  is,  it  is  modified  according  to  control 
specifications  contained  within  the  file  itself.  TFS  is  a  program  which 
interprets  these  control  specifications  and  produces  the  formatted  listing. 


TFS  IN  GENERAL 


These  control  specifications,  hereafter  referred  to  as  C-specs,  are 
commands  of  the  form  '%N\ME',  where  '%'  designates  that  a  command  name  Follows 
and  'NAME',  a  character  string  of  up  to  four  characters,  is  the  name  of  the 
C-spec.  For  example,  the  C-spec  which  turns  on  underlining  in  TFS  is  *1UL' ; 
every  word  which  follows  a  tUL  is  underlined  until  another  %UL  is  encountered. 

Naturally,  as  one  may  notice  at  this  point,  a  string  starting  with  a  '%' 
designates  a  C-spec,  and  this  seems  to  prohibit  the  use  of  the  '%'  character  as 
the  first  character  of  a  word.  This  assumption,  however,  is  not  the  case.  An 
escape  sequence,  '%%' ,  has  been  designated  to  eliminate  this  problem.  Any  word 
starting  with  a  '%%'  is  displayed  as  that  word  beginning  with  a  single  ’%';  for 
example,  't%this'  is  printed  by  TFS  as  'tthis'. 

A  word,  as  defined  by  TFS,  is  a  string  of  characters  delimited  by  either 
two  blanks,  the  beginning  of  a  line  and  a  blank,  the  beginning  of  a  line  and  a 
carriage  return,  or  a  blank  and  a  carriage  return.  Hence,  a  word  is  any  string 
like  'string',  where  'string'  is  delimited  by  blanks  like  '  string  ',  and  words 
may  not  cross  line  boundaries  in  an  CP/M  text  file,  since  CP/M  defines  each  line 
of  its  files  to  be  terminated  by  a  carriage  return  character  (ASCII  OD 
hexadecimal)  and  a  line  feed  character  (ASCII  OA  hexadecimal).  TFS  is  a 
word-oriented  text  formatter.  It  places  words  in  an  output  line  until  the  line 
is  filled,  and  then  It  prints  the  line.  TFS  analyzes  each  word  as  it  reads  the 
word  from  the  CP/M  text  file,  checks  to  see  if  the  word  is  a  C-spec,  formats  the 
word  if  it  is  not  a  C-spec  and  executes  the  C-spec  if  it  is,  and  then  continues 
by  reading  the  next  available  word  in  the  file.  TFS  continues  until  it  reaches 
the  end  of  the  file. 

TFS  operates  in  basically  two  modes:  (1)  ASIS  mode  (see  the  %ASIS  command) 
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and  (2)  normal  mode.  In  normal  node,  TPS  will  read  wards  from  the  CP/M  text 
file,  building  the  current  output  line  as  it  goes.  All  output  lines  are  of  a 
definite  length,  defined  either  by  default  or  explicitly  by  the  user,  and  TPS 
puts  the  words  it  reads  into  the  current  output  line  buffer  until  it  reads  a 
word  too  large  to  fit  in  the  remaining  space.  If  there  are  no  words  in  the  line 
at  this  time,  it  will  force  the  word  into  the  line  and  print  the  line; 
otherwise,  it  will  output  the  line.  In  outputting  a  line  with  right 
justification,  TPS  inserts  blanks  between  words  in  the  output  line  buffer  until 
there  is  a  specified  number  of  characters  in  the  line  (the  length  of  the  line! . 
It  will  insert  these  blanks  starting  at  the  right  erri  of  the  line,  going  to  the 
left.  As  a  result,  the  left  and  right  margins  of  a  page  produced  by  TPS  line  up 
if  right  justification  is  employed.  If  right  justification  is  not  employed,  TPS 
simply  outputs  the  line  without  filling  it.  Right  justification  is  the  default. 

While  creating  the  output  line  in  normal  mode,  TPS  follows  the  convention 
that  all  words  ending  in  a  special  character  or  '?'l  are  followed 
by  two  blanks;  all  other  words  are  followed  by  one  blank.  It  is  felt  that  this 
convention  improves  readability  of  the  line. 

In  ASIS  mode,  TPS  simply  outputs  the  lines  following  the  %ASIS  C-spec 
exactly  as  they  appear.  Refer  to  the  documentation  on  the  tASIS  command. 


TPS  C-SPECS 


As  mentioned  earlier,  TPS  recognizes  many  commands  (or  C-specs*  during  the 
formatting  of  an  ARIAN  file.  These  C-specs  all  take  the  form  of  ’tMAMS',  where 
•%'  indicates  that  a  C-spec  name  follows,  and  'NAM5'  is  the  name  of  the  C-spec. 
•NAME'  may  contain  any  combination  of  upper-  and  lower-case  characters;  TPS 
converts  all  lower-case  characters  in  the  name  of  a  C-spec  to  upper-case.  The 
following  is  a  list  of  all  C-specs  recognized  by  TPS;  the  chapters  of  this 
manual  will  describe  these  C-specs  in  detail. 

Type  of  C-spec:  Output  Control 

UL,  RJ,  NORJ,  ASIS,  BR,  CR,  AP,  P,  PX,  PAGE,  SKIP  n,  HEAD  text, 

FOOT  text,  T  n,  C  text,  CB,  CH  n  text,  COPY  n,  ENDC,  LOOP,  ENDL, 

TP  n,  LEX,  BS,  N,  R  r,  and  DR  r 

Type  of  C-spec:  Parameter  Set 

PVR  n  m,  PARX  n  m,  LMAR  n,  LLEN  n,  LINE  n  m,  PGDN  n, 

PGOP,  PNIW  n,  SP  n,  BLK  c,  SETN  n,  SETR  r  n,  INCR  r,  and  CLRR 

Type  of  C-spec:  Data  Pile  Manipulation 
OPEN  filename,  CLOS,  and  READ 

Type  of  C-spec:  Miscellaneous 

SAV,  RES,  PAUS  text,  REM  text,  APND  filename,  MAC,  ENOM,  KB  text, 

EXIT,  STOP,  HALT 
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THE  TPS  COMMAND 


TFS  is  invoked  by  typing  the  TFS  command.  This  command  causes  the  TPS 
program  to  be  loaded  into  memory  and  executed. 

The  TFS  command  has  four  options.  These  options  permit  the  user  to:  (l) 

have  TFS  stop  after  printing  each  page,  thereby  allowing  the  user  to  change 
paper,  (2)  to  display  the  formatted  output  on  the  user's  CRT  one  line  at  a  time, 
(3)  to  have  TFS  skip  to  a  specified  page  and  start  printing  the  report  at  that 
page,  and  (4)  to  have  TPS  send  the  formatted  output  to  disk.  '/P'  invokes  the 
first  option,  while  */Sn',  where  *n*  is  a  page  number  (1-9999),  causes  TPS  to 
skip  to  the  specified  page  and  start  printing  on  this  page.  '/V'  invokes  the 
second  option.  As  the  user  may  suspect,  /V  and  /Sn  and  well  as  /P  and  /Sn  may 
be  combined  in  the  command  line.  It  makes  no  sense  to  combine  /V  and  /P,  since 
/V  stops  after  every  line  anyway.  '/D'  invokes  the  fourth  option;  when  invoked, 
the  file  ' filename.DOC'  is  generated,  and  the  user  is  asked  which  disk  he  wishes 
it  to  be  placed  on.  /D  overrides  /V  if  both  options  are  specified. 

The  TFS  command  line,  therefore,  takes  the  form  — 


TPS  d:filename.ext  /o 


where  *d: '  is  optional  and  may  specify  a  drive,  '.ext'  is  optional  ('.TPS*  is 
the  default),  and  '/o'  is  an  option.  If  an  invalid  option  is  specified,  TFS 
will  display  the  valid  options  and  abort;  hence,  if  the  user  desires  a  brief 
on-line  memory  refresh  of  the  TFS  options,  he  may  type  something  like  •/?'  and 
receive  the  valid  option  list. 
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CHAPTER  2 

Output  Control  C-specs 


The  output  control  C-specs  control  the  output  of  TPS  directly.’  They 
include: 

1)  Line  control  C-specs,  such  as  AASIS,  %3R,  ACR, 

and  %SKIP. 

2)  Page  control  C-specs,  such  as  APAGE,  %TP,  and 

tCH. 

3)  Format  control  C-specs,  such  as  %UL,  AHEAD, 

AFOOT,  %C,  ACB,  %RJ,  ANORJ,  *3S,  %T,  AN,  %R, 
and  ADR. 

4»  Paragraph  control  C-specs,  such  as  AAP,  AP  and 
APX. 

5)  and  the  Copy  control  C-specs,  ACOPT,  AEMDC, 

ALOOP,  AEMDL,  and  ALEX.' 


The  AASIS  C-spec  instructs  TFS  to  display  the  following  lines  exactly  as 
they  are  without  filling  the  output  lines.  Only  the  spacing  control  is  carried 
over  the  AASIS  C-spec;  for  instance,  if  the  output  is  double-spaced  when  the 
AASIS  is  encountered,  the  lines  within  the  AASIS  block  are  also  double-spaced. 

An  AASIS  block  consists  of  a  line  of  the  CP/M  text  file  to  be  formatted 
which  contains  the  C-spec  'AASIS'  followed  by  an  optional  comment,  the  lines  to 
be  printed  "asis",  and  a  terminating  line  beginning  with  the  character  'A'.  The 
terminating  line  must  start  with  the  'A'  character  in  the  first  valid  character 
position  of  the  line.  For  example,  a  typical  AASIS  block  would  be: 

AASIS  [comment] 

[text  to  be  displayed  without  formatting] 

AASIS  [comment] 


The  only  restriction  placed  on  an  'AASIS'  block  is  that  the  'A'  character 
may  not  be  placed  in  the  first  valid  character  position  of  a  line  without 
terminating  the  'AASIS'  block. 

All  text  within  an  AASIS  block  is  displayed  in  the  same  form  as  it  exists 
within  the  source  text,  with  the  exception  that  spacing  is  carried  over  from  the 
last  ASP  command.  Also,  tabs  are  expanded  within  the  AASIS  block,  so  it  appears 
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as  it  was  typed  into  the  source  text  file  by  using  an  editor  like  ED, 


The  * %’JL '  C-spec  is  used  to  start  and  stop  the  underlining  process.  The 
group  of  characters  to  be  underlined  are  enclosed  in  *%UL'  C-specs.  For 
example,  a  typical  use  of  %'JL  is: 

This  text  will  not  be  underlined.  %UL  This  text  will  be 
underlined.  %UL  This  text  will  not. 


LINE  OUTPUT 


Lines  may  be  terminated  in  one  of  three  ways:  (l)  automatically  when  TFS 
determines  that  the  next  word  will  not  fit  in  the  current  output  line,  (2)  in  an 
implied  way  when  certain  TFS  C-specs,  such  as  %P,  force  the  output  of  the 
current  line  by  the  nature  of  their  function,  and  (31  explicitly  in  the  use  of 
the  %9R  and  %CR  C-specs. 

%3R  (break)  and  %CR  (carriage  return)  force  the  output  of  whatever  is  in 
the  output  line  buffer.  If  more  than  10  characters  are  required  to  fill  the 
line  to  make  the  margins  line  up,  the  line  is  not  filled  —  it  is  output  exactly 
as  it  exists  in  the  buffer.  Otherwise,  the  line  is  filled  as  described  earlier. 

%BR  breaks  the  output  line.  If  the  output  line  buffer  is  empty,  nothing 
happens  on  the  printer;  if  it  contains  something,  it  is  printed,  and  a  carriage 
return/line  feed  is  output.  %CR  always  performs  a  carriage  return/line  feed. 
If  the  output  buffer  is  not  empty,  it  acts  like  a  %BR;  if  the  buffer  is  empty, 
it  outputs  just  a  carriage  return/line  feed.  Hence,  if  the  user  wishes  to  skip 
down  one  or  two  lines,  he  may  insert  two  %CR's  at  the  appropriate  place. 

Along  the  same  lines  as  %3R  and  %CR,  the  %SKIP  C-spec  also  can  be  used  to 
terminate  a  line.  %SKIP  is  always  to  be  followed  by  a  number  1-99;  it  acts  like 
the  specified  number  of  %CR's.  Unlike  %CR,  however,  if  the  end  of  the  page  is 
encountered  before  the  skipping  is  completed,  a  page  eject  is  done  and  the 
skipping  is  stopped.  For  example,  if  only  three  lines  are  left  on  the  page  and 
a  %SKIP  10  is  encountered,  then  only  a  page  eject  will  be  done. 

If  the  user  wishes  to  skip  down  for  the  purpose  of  inserting  a  diagram  in 
the  text,  %SKIP  alone  may  not  be  adequate.  If  the  diagram  is  to  require  ten 
lines  and  only  five  lines  are  left  on  the  page,  %SKIP  will  leave  only  five  lines 
for  the  diagram. 

To  get  around  this  problem,  the  %TP  (test  page)  C-spec  is  implemented. 
This  C-spec,  which  is  also  always  followed  by  a  number  from  1-99,  tests  to  see 
if  the  specified  number  of  physical  lines  is  left  on  the  current  page,  and,  if 
such  is  not  the  case,  it  forces  a  page  eject.  Hence,  to  ensure  leaving  ten 
lines  for  the  diagram,  a  %TP  10  followed  by  a  %SKIP  10  may  be  used.  If  the  ten 
lines  are  not  available  on  the  current  page,  a  page  eject  is  done  followed  by 
the  skip;  otherwise,  just  the  skip  is  done. 

Another  C-spec  available  to  the  user  is  the  %PA3E  C-spec,  which  forces  a 
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page  eject.  The  ad/antages  of  this  C-spec  are  obvious. 

The  normal  output  of  TFS  is  right-  and  left-justified,  and  TFS  provides  two 
tx>ntrol  C-specs  which  may  be  used  to  selectively  engage  and  disengage  the  right 
justification  feature.  %RJ  engages  right  justification,  and  %NORJ  disengages 
it.  Right  justification  is  the  default. 


PARAGRAPHS 


TFS  supports  basically  two  types  of  paragraphs  —  normal,  indented 
paragraphs  and  exdented  paragraphs.  Indented  paragraphs  are  as  one  would  expect 
a  paragraph  to  be.  The  paragraph  starts  with  the  first  word  indented  a 
specified  number  of  characters  in  from  the  left  margin.  TFS  permits  indentation 
of  from  0  to  99  characters. 

Exdented  paragraphs  are  displayed  as  the  first  line  extending  a  specified 
number  of  characters  to  the  left  of  the  left  margin.  The  lists  presented  in 
this  manual  are  formed  using  exdented  paragraphs.  Obviously,  the  left  margin 
mist  be  greater  in  length  than  the  number  of  characters  to  be  extended;  if  such 
is  not  the  case,  an  error  message  is  printed  in  the  output.  It  mates  no  sense 
to  extend  a  line  beyond  the  first  character  space  the  printer  can  print  in. 

The  %PAR  and  %PARX  C-specs  define  the  characteristics  of  the  paragraphs  to 
follow.  These  C-specs,  which  are  described  in  detail  later,  set  the  number  of 
characters  to  be  indented  and  exdented. 

The  %P  and  %?X  C-specs  tell  TFS  that  an  indented  or  exdented  paragraph 
starts  with  the  next  word.  The  current  output  line  is  broken  (%3R»  and  the  new 
paragraph  is  started  when  these  C-specs  are  encountered. 

Another  feature  of  TFS  is  the  automatic  paragraphing  facility.  This 
feature,  invoked  by  the  %AP  C-spec,  makes  any  line  of  source  text  not  in  an 
%ASIS  block  whose  first  character  is  a  space  or  tab  the  first  line  of  a  new 
indented  paragraph.  %AP  is  a  toggle  C-spec;  that  is,  if  automatic  paragraphing 
is  off,  %AP  engages  it,  and  if  automatic  paragraphing  is  on,  %AP  disengages  it. 
Hence,  the  following  example  demonstrates  the  use  of  %AP  — 


IAP 

This  is  the  first  line 
of  a  new  paragraph.  Tnis  paragraph 
will  be  formatted  as  a  paragraph 
until  another  line  beginning  with  a  space 
or  caD  character  is  encountered. 

This  is  the  second  paragraph. 

This  is  the  third. 

%AP  %REM  Automatic  paragraphing  is  now  off. 
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HEADINGS,  FOOTINGS,  and  CHAPTERS 


The  AHEAD  C-spec  permits  the  user  to  place  a  heading  at  the  top  of  each 
page.  This  C-spec  takes  the  form  of  'AHEAD  text'  on  one  line  of  the  file.  Only 
the  AT,  AR,  AD  (ADR) ,  and  A#  C-specs  may  be  placed  in  the  text  following  the 
AHEAD  C-spec,  and  all  of  the  text  following  this  C-spec  to  the  end  of  the  line 
in  the  file  is  used  as  the  heading. 

When  a  page  eject  occurs  and  ARSON  and  AHEAD  are  in  effect,  the  first 
printed  line  contains  the  page  number.  This  is  followed  by  the  number  of  blank 
lines  specified  by  the  line  spacing  C-spec  (ASP  n  —  see  later)  and  the  heading 
followed  by  one  additional  blank  spaced  line.  Por  instance,  if  the  output  is 
double  spaced,  one  blank  line  follows  the  line  containing  the  page  number  and 
three  blank  lines  (1  blank,  1  blank  for  the  next  normal  line  in  spacing,  and  1 
blank  to  follow  that  line)  follow  the  heading.  If  APGON  is  not  in  effect,  then 
the  heading  only  will  appear  at  the  top  of  the  page.  The  AFOOT  C-spec  is  used 
to  place  a  footer  at  the  bottom  of  a  page.  It  is  structured  like  AHEAD,  and  the 
footer  appears  after  the  last  text  line  on  the  page.  At  least  three  blank  lines 
must  be  present  in  the  bottom  margin. 

As  mentioned  above,  the  AT,  AR,  AD,  and  Al  C-specs  are  the  only  C-specs 
which  may  appear  in  header  and  footer  specifications.  The  AT  C-spec  is  defined 
exactly  as  it  normally  is;  it  takes  the  form  of  'AT  n' ,  and  its  effect  is  to 
tabulate  to  the  specified  colunn.  The  AR  and  AD  C-specs  function  as  AR  and  ADR 
normally  function;  each  is  followed  by  the  number  of  the  register  to  display. 
AR  displays  the  value  of  the  specified  register  and  increments  it,  while  AD 
displays  the  value  of  the  specified  register  and  does  not  increment  it.  The  Al 
C-spec  is  unique  to  header  and  footer  entries.  This  C-spec  produces  the  number 
of  the  current  page  (four  digits) .  Hence,  the  normal  page  numbering  scheme  with 
the  APGON  C-spec  need  not  be  used,  and  the  user  may  create  his  own  headers  and 
footers  to  include  the  current  page  number  as  he  desires.  A  typical  footer  may 
look  like: 


AFOOT  Chapter  AD  0  AT  60  Page  A« 


The  chapter  C-spec,  ACH,  is  of  the  form  'ACH  n  text',  where  'n'  is  the 
chapter  number  1-99  and  'text'  is  the  chapter  title.  ACH  forces  a  page  eject, 
skips  down  10  physical  lines,  centers  the  word  'CHAPTER'  and  the  chapter  number, 
skips  down  two  blank  spaced  lines  (3  physical  lines  if  double  spaced,  1  physical 
line  if  single  spaced,  5  if  triple,  etc.),  and  centers  the  text  of  the  chapter 
title.  As  with  all  centering,  the  next  word  after  the  ACH  C-spec  must  be  a 
C-spec  which  breaks  the  output  line  with  a  carriage  return  (see  the  section  on 
centering) .  Por  example,  such  a  C-spec  may  be  ACR,  AP,  or  APX. 

CEWTERIN3 


Centering  is  done  explicitly  in  TPS  by  using  the  AC  and  ACB  C-specs  and 
implicitly  by  using  the  ACH  C-spec.  Centering  always  involves  breaking  the 
current  line  and  starting  a  new  line.  The  AC  C-spec  is  of  the  form  'AC  text'. 
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where  text  is  terminated  by  the  end  of  the  current  line  in  the  CP/M  text  file. 
When  %C  is  encountered  the  output  buffer  is  broken,  and  the  centering  is  done  on 
the  next  physical  line  of  the  printed  output.  Since  spacing  is  done  after  a 
line  is  printed,  centered  lines  in  a  single-spaced  section  of  text  will  be  on 
the  next  physical  line  ana  cem.«red  lines  on  double-spaced  sections  of  text  will 
be  an  the  second  physical  line  following  the  broken  line. 

The  ICB  (Center  Block)  C-spec  is  used  to  center  a  block  of  lines.  Upon 
encountering  %C8,  the  current  output  line  is  broken  and  centering  begins  with 
the  word  following  the  %CB.  The  lines  are  centered  according  to  their  physical 
composition  in  the  source  file;  l.e.,  each  line  in  the  source  file  is  centered 
by  itself  without  the  normal  TOS  function  of  searching  for  the  next  word 
regardless  of  source  line  boundaries.  Centering  continues  until  another  «CB  is 
encountered,  at  which  time  the  current  output  line  is  centered  and  the  following 
word  is  the  next  word  to  be  processed  in  a  normal  TPS  manner. 

The  normal  TFS  commands,  including  macros  and  underlining,  are  valid  during 
centering,  so  centered  text  may  be  processed  normally  in  addition  to  being 
centered.  Note,  however,  that  C-specs  like  ISKIP  are  also  engaged  and  may 
impact  on  the  centering  process. 

The  following  is  an  example  of  the  two  center  C-specs  of  TPS  — 

%c  This  line  will  be  centered 

This  line  will  not.  %cb  Centering  starts  now. 

This  line  will  be  centered. 

As  will  this  one. 

This,  also.  %cb  This  will  not. 


TABBING 


Tabulation  can  be  done  explicitly  by  using  the  %T  C-spec .  This  C-spec  is 
of  the  form  'IT  n*,  where  n  is  the  nunber  of  the  column  to  tab  to.  If  the 
output  line  pointer  is  already  beyond  this  column,  no  tabulation  will  be  done 
and  an  error  message  will  appear  on  the  console. 


NUMBERING  and  BACKSPACING 


Two  C-specs  included  at  this  time  are  IBS  and  IN.  These  C-specs  give  the 
user  seme  additional  control  over  the  format  of  the  output  that  is  particularly 
advantageous. 

IBS  is  the  backspace  C-spec.  It  has  no  arguments,  and  its  function  is  to 
perform  a  backspace  in  the  output  line  buffer.  As  each  word  is  stored  in  the 
output  line  buffer,  it  is  followed  by  one  or  two  blanks.  If  it  does  not  end  in 
a  terminating  character  like  (specified  earlier),  it  is  followed  by  one 
blank;  if  it  ends  in  such  a  character  it  is  followed  by  two  blanks.  «BS  backs 
up  the  pointer  which  points  to  the  next  available  character  position  in  the 
buffer;  hence,  it  erases  a  blank  following  the  last  word  placed  in  the  buffer. 
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%3S  effectively  concatenates  the  next  word  to  be  placed  in  the  buffer  with  the 
last  word  placed  in  the  buffer.  This  is  particularly  useful  in  cases  where  a 
C-spec  which  affects  its  arguments  globally  must  be  restrained. 

As  a  case  in  point,  %UL  is  such  a  C-spec.  If  the  user  wishes  to  underline 
a  word,  for  instance,  and  terminate  the  word  with  a  piece  of  punctuation  which 
is  not  underlined,  %BS  makes  this  possible.  For  example, 

%UL  ITS  »UL  %9S  . 


makes  the  string  'TFS. '  possible. 

Two  problems  with  using  %BS  should  be  noted  at  this  time.  The  first 
problem  is  that  if  the  string  to  be  concatenated  to  the  word  in  the  buffer  would 
result  in  a  line  overflow,  TFS  will  not  permit  the  concatenation  to  occur.  For 
example,  if  'stand1  is  concatenated  to  'under*  and  there  are  only  two  spaces 
left  in  the  output  line  buffer  (i.e.,  'understand'  will  overflow  the  right 
margin  by  three  spaces),  concatenation  will  not  occur  and  'stand'  will  appear  as 
the  first  word  of  the  next  line.  Hence,  as  a  general  rule,  it  is  best  to  use 
%3S  to  append  a  single  character  to  the  last  word  in  the  output  buffer.  One  may 
safely  append  larger  strings  only  if  he  is  sure  that  an  overflow  will  not  occur. 

The  second  problem  is  that  IBS  will  not  work  if  the  output  buffer  is  empty. 
No  significant  error  will  occur,  but  the  concatenation  to  the  desired  word  may 
not  occur.  Specifically,  if  the  word  to  be  appended  to  was  the  last  word  of  the 
line  just  printed,  then  the  backspace  will  be  ineffective. 

Numbering  is  the  second  item  oovered  in  this  section.  It  was  included 
primarily  because  backspacing  often  accompanies  numbering  in  TFS,  such  as  in  the 
numbering  of  list  items. 

The  IN  C-spec  is  used  to  enable  automatic  numbering.  TFS  supplies  a  number 
buffer  to  the  user;  this  buffer  is  initialized  to  l  when  TFS  is  first  invoked 
and  can  be  set  by  the  %SETN  C-spec  (see  later) .  Whenever  %N  is  encountered  the 
value  in  this  buffer  (1-99)  is  placed  in  the  output  buffer  as  a  two-character 
word.  If  the  value  is  between  1  and  9,  the  first  character  is  a  blank.  After 
the  word  is  placed  in  the  output  buffer,  the  value  of  the  number  buffer  is 
incremented.  Hence,  successive  occurances  of  %N  result  in  successive  numbers 
being  placed  in  the  output  line,  like  'ISETN  1  IN  IN  tN'  results  in  1  2  3. 
This  is  particularly  useful  in  producing  numbered  lists,  where  the  user  may  wish 
to  insert  an  element  into  a  list  at  a  later  time  and  does  not  wish  to  manually 
renumber  the  lists  in  the  CP/M  text  file.  All  lists  in  this  manual  are  produced 
by  using  %N  followed  by  a  IBS  and  a  ')'  as  the  first  words  in  an  extended 
paragraph  (see  the  list  at  the  beginning  of  this  chapter). 
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REGISTERS  and  REGISTER  NUMBERING 


In  addition  to  the  number  buffer,  ITS  supplies  100  registers  to  the  user. 
These  registers  are  referenced  by  number,  their  nunbers  ranging  from  0  to  99. 
They  may  be  set,  incremented,  and  displayed  by  the  user  at  his  convenience. 

All  registers  are  initialized  to  1  when  TPS  is  Invoked  and  whenever  the 
%CLRR  C-spec  (see  later)  is  encountered.  Two  C-specs  are  available  to  display 
the  contents  of  a  register  —  %R  and  %DR.  '%R  n'  displays  the  contents  of 
register  n  as  a  two  character  number  (blank  filled)  and  increments  the  register, 
while  '%DR  n'  displays  the  contents  of  the  register  and  does  not  increment  it. 

%R  and  IDR  functions  are  also  available  in  headers  and  footers;  the  C-specs 
in  this  case  are  tR  and  %D. 

TWo  other  C-specs ,  tINCR  and  %SETR,  are  used  to  increment  a  register  and 
set  its  value.  These  are  discussed  later. 

COPYING 


The  last  C-specs  to  be  described  in  this  chapter  are  %C0PY,  I5MX,  ILOQP, 
%ENOL,  and  %LEX.  These  C-specs  allow  the  user  to  copy  sections  of  the  file  up 
to  99  times.  With  these  C-specs,  all  or  selected  sections  of  the  CP/M  text  file 
may  be  duplicated  in  the  output. 

%C0PY  takes  the  form  'ICOPY  n' ,  where  ’n'  is  the  number  of  copies  (1-99)  to 
be  made.  The  first  word  of  the  block  to  be  copied  is  the  first  word  of  the  line 
following  the  line  containing  the  %C0PY  C-spec.  For  example, 

%COPY  2  IP  This 

will  be  copied  twice.  IENDC  This  once. 


The  entire  file  may  be  copied  by  placing  %C0PY  after  the  last  macro 
definition  in  the  file  (see  the  section  on  macros  later)  and  by  placing  IOOC  as 
the  last  word  in  the  file. 

The  ILOQP  and  %ENDL  C-specs  perform  the  same  type  of  function  as  %C0PY  and 
IENDC,  but  they  establish  an  •infinite*  loop.  This  loop  can  only  be  terminated 
by  a  loop  exit  C-spec,  %LEX,  or  a  TPS  exit  C-spec,  %EXIT.  The  ILOQP  and  IENDL 
C-specs  find  their  value  in  applications  where  the  user  doesn't  know  how  many 
copies  he  wants,  the  user  wants  more  than  99  copies,  and  the  user  is  generating 
his  copies  from  a  data  file  and  he  is  terminating  the  process  by  placing  a  ILEX 
zr  an  I5XIT  C-spec  in  the  data  file.  All  words  following  ILEX  in  a  Data  File 
record  are  ignored. 

IL00P  and  IENDL,  like  ICOPY  and  IENDC,  bracket  the  text  to  be  repeated. 
ILEX  must  appear  somewhere  within  a  loop  bracketed  by  tLOOP  and  ISNDL;  an  error 
is  given  and  processing  is  terminated  if  ILEX  does  not  appear  within  such  a 
loop. 
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Loops  may  not  extend  beyond  the  resident  TFS  source.  That  is,  a  loop  may 
not  be  begun  in  one  TFS  source  file,  an  append  be  performed,  and  the  loop  is 
terminated  in  the  appended  file.  Any  attempt  to  do  so  results  in  a  TFS  fatal 
error. 
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CHAPTER  3 

Parameter  Set  C-specs 


The  Parameter  Set  C-specs  are  used  to  assign  values  to  the  various  control 
settings  used  by  TPS.  These  C-specs  include: 

1)  Paragraph  parameter  C-specs,  such  as  %PAR  and 

%PARX, 

2)  Line  parameter  C-specs,  such  as  %LMAR  and 

%LLEN, 

3)  Page  parameter  C-specs,  such  as  tLINE,  %PGON, 

%P50F,  and  %PNUM, 

4)  the  Spacing  parameter  C-spec,  %SP, 

5)  the  significant  blank  character  definition 

C-spec,  %BLK, 

6)  and  the  N  and  R  parameter  C-specs,  %SETN, 

%CLRR,  %INCR,  and  tSETR. 


All  Parameter  Set  C-specs  except  %PNUM  (see  below)  are  effective 
immediately.  Por  example,  once  %PAR  is  used,  all  subsequent  paragraphs  created 
by  %P  are  affected;  additionally,  the  current  paragraph  is  also  affected 
immediately. 


The  paragraph  parameter  C-specs  set  the  indentation  or  exdentation  number 
and  the  number  of  spaced  lines  to  be  placed  between  paragraphs.  Both  %PAR  and 
IPARX  have  two  numeric  arguments  —  the  first  sets  the  indentation  or 
exdentation  and  the  second  sets  the  number  of  spaced  lines  to  be  placed  between 
paragraphs.  As  in  most  numeric  parameters,  these  may  take  on  the  values  from  1 
to  99.  Por  example,  ’%PAR  5  1'  establishes  an  indentation  of  5  spaces  and  the 
number  of  spaced  lines  to  1.  If  the  output  is  double  spaced,  three  blank  lines 
(1  associated  with  the  last  line  of  the  paragraph  and  2  associated  with  the 
skipped  line)  are  placed  between  each  paragraph.  Indented  and  exdented 
paragraphs  are  discussed  in  the  previous  chapter. 

The  ILMAR  and  %LLEN  C-specs  set  the  location  of  the  left  margin  and  the 
length  of  the  output  line.  '%LMAR  n'  sets  the  left  margin  at  'n'  characters 
right  of  the  physical  left  end  of  the  carriage;  'ILLBN  n*  sets  the  length  of  the 
line  to  'n*  characters,  starting  at  the  current  position  of  the  left  margin. 
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The  effects  of  these  C-specs  are  order-dependent  to  some  extent.  Since 
%LLEN  sets  the  position  of  the  right  margin  based  upon  its  argument  and  the 
position  of  the  left  margin  and  %LMAR  ignores  the  length  of  the  line,  if  an 
%LHAR  C-spec  is  executed  after  a  %LLEN  C-spec,  the  new  line  length  is  the 
difference  between  the  old  line  length  and  the  new  left  margin.  For  example,  if 
'%LLSN  80  %LMAR  10'  is  encountered  in  the  text,  the  new  line  length  would  be  70. 
However,  if  '%LMkR  10  %LLSN  80’  is  encountered,  the  new  line  length  would  be  80. 
The  %LUEN  C-spec  adds  its  argiment  to  the  current  position  of  the  left  margin. 

The  ILIN5  C-spec  sets  the  format  of  the  output  page.  %LINE  has  two 
arguments  —  the  number  of  physical  text  lines  on  the  output  page  and  the  number 
of  physical  lines  on  the  output  page.  For  instance,  *%LINE  40  51*  specifies 
that  there  are  to  be  40  physical  text  lines  (including  spacing)  on  a  page  and  51 
physical  lines  on  a  page.  Hence,  when  TFS  is  started  and  this  instruction  is 
encountered,  TFS  starts  counting  down  from  40  with  the  line  on  which  the  user 
set  the  Top-of-Form,  and,  when  it  has  counted  40  lines,  it  skips  down  11  (51-40) 
for  the  next  page. 

The  %P30N  and  %PG0F  turn  on  and  off  the  automatic  page  numbering  facilities 
of  TFS.  %PG0N  has  one  argument,  the  column  number  from  Which  the  page  numbers 
will  be  right-justified.  For  example,  *%PG0N  60'  right- justifies  the  page 
numbers  in  column  60,  so  page  1  will  print  the  1  in  column  60  and  page  10  will 
print  the  0  in  column  60  and  the  1  in  59.  %PGOF  turns  off  the  automatic  page 
numbering  facility.  Note  that  paging  itself  is  always  engaged  with  TFS. 

1PNUM  sets  the  number  of  the  next  page  to  be  printed  to  the  value  of  its 
argument.  Unlike  the  other  C-specs,  IPNUM  is  not  effective  immediately  —  its 
value  applies  to  the  next  page  rather  than  the  current  page.  Hence,  '%PNUM  5 
%  PASS'  would  result  in  the  page  supplied  by  the  page  eject  (%PA3£)  command 
having  a  number  of  5.  %PGQN  must  be  in  effect  for  this  C-spec  to  work. 

%SP  sets  the  spacing  of  the  line.  This  C-spec  is  of  the  form  '*SP  n' , 
where  'n'  may  take  on  values  from  1-99.  '%SP  2'  sets  double  spacing,  *%SP  l* 
sets  single  spacing,  etc.  '%SP  O'  is  not  recommended  since  results  are 
sometimes  unpredictable. 

%3LK  defines  the  significant  blank  character.  This  C-spec  is  of  the  form 
*%3LK  c*,  where  *c'  is  a  single  character.  Once  this  C-spec  is  employed, 
whenever  the  character  'c*  is  encountered,  a  blank  is  printed  in  its  place. 
This  significant  blank  character  may  be  redefined  at  any  time.  When  TFS  is 
first  invoked,  no  significant  blank  character  is  defined. 

%SETO  n  sets  the  value  of  the  number  buffer  to  the  specified  value  (0-99). 
This  C-spec  is  used  to  initialize  the  number  buffer  for  subsequent  uses  of  the 
%N  C-spec  (described  earlier) . 

The  final  three  C-specs  in  this  chapter  are  ICLRR,  IINCR,  and  ISBTR.  They 
manipulate  the  103  registers  of  TFS  without  printing  any  values.  %CLRR  takes 
the  simple  form  of  '%CLRR' ,  and  this  command  sets  the  values  of  all  the 
registers  to  1.  tltCR  takes  the  form  of  '%INCR  r',  and  it  increments  the  value 
of  register  r.  Finally,  %SETR  takes  the  form  of  'ISETR  r  n',  and  it  sets  the 
value  of  register  r  to  n. 
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CHkPTER  4 

Data  File  Manipulation  C-specs 


TFS  supports  two  basic  designations  of  files  —  TFS  Source  Files  and  TFS 
Data  Files.  Physically,  there  is  no  difference  between  these  types  of  files; 
both  may  be  created  by  CP/M  in  the  same  way,  and  they  may  be  stored  on  disk  and 
referenced  by  TFS.  The  difference  between  these  two  files  is  in  their 
application.  TFS  Source  Files  are  processed  directly  and  normally  by  TFS.  TFS 
Data  Files,  however,  are  processed  indirectly  by  TFS;  while  processing  a  TFS 
Source  File,  elements  from  the  TPS  Data  File  are  inserted  into  the  output 
listing  one  record  at  a  time,  a  record  being  defined  as  one  line  of  a  TFS  Data 
File. 

The  TFS  C-specs  whLch  are  used  to  mar.  I  pul  ate  TFS  Data  Files  are: 

1)  The  %OPEN  C-spec,  which  is  used  to  open  a  Data 
File, 

21  The  %CL05  C-spec,  which  is  used  to  close  a 
Data  File,  and 

3*  The  %RE*D  C-spec,  which  is  used  to  read  a 
record  from  a  Data  File. 


OPENING  and  CLOSING  DMA  FILES 


Before  a  TFS  Data  File  may  be  used,  it  must  be  opened.  This  function 
serves  to  locate  the  data  file,  initialize  the  resident  buffer  for  it,  and  set  a 
number  of  internal  variables.  This  is  done  by  using  the  %OPEN  C-spec.  This 
C-spec  is  of  the  form  '%OPEN  D: FILENAME. EXT'.  Only  one  data  file  may  be  opened 
at  one  time.  Both  the  drive  specification  and  extension  are  optional.  If 
omitted,  the  drive  spec  defaults  to  the  currently  logged-in  drive  and  the 
extension  defaults  to  blank. 

Similarly,  when  a  user  has  finished  with  one  data  file  and  wishes  to  use 
another,  the  %CLOS  C-spec  is  used  to  close  an  opened  Data  File,  thereby  enabling 
the  user  to  open  another  Data  Pile.  The  %CLOS  C-spec  is  simply  of  the  form 
•%CLOS'. 

Data  Files  may  reside  on  any  Disk  Drive,  and  the  user  must  take  care  not  to 
Change  disks  While  a  data  file  is  in  use.  TFS  makes  no  checks  to  see  if  this 
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was  done,  and  subsequent  loads  of  the  Data  File  buffers  will  come  from  the  disk 
addresses  of  the  data  file  on  the  original  disk  if  this  occurs.  No  prediction 
can  be  made  as  to  the  results. 


READIN3  TFS  DATA  FILES 


Once  a  Data  File  has  been  opened,  the  user  will  want  to  read  records  from 
it  and  insert  them  into  his  output.  This  is  done  by  using  the  %READ  c-spec. 

A  record  takes  the  form  of  a  line  in  the  data  file.  When  a  %READ  is 
encountered,  the  internal  TFS  word  pointer  is  saved,  and  it  is  then  set  to  point 
at  the  first  word  of  the  next  record  in  the  data  file.  Words  are  then  pulled 
from  the  data  file  until  the  end  of  the  record  (end  of  line*  is  reached.  At 
this  time,  the  original  word  pointer  is  restored  and  processing  continues  with 
the  word  following  the  1READ.  An  arbitrary  number  of  words,  including  none  at 
all,  may  exist  in  a  record  within  the  data  file. 

The  records  of  a  data  file,  then,  are  read  and  processed  exactly  as  if  they 
simply  existed  within  the  source  file.  This  greatly  extends  the  flexibility  of 
TFS,  since  words  within  a  record  may  be  TFS  commands.  Only  the  %READ,  %CLOS, 
%ASIS,  %LOOP,  %COPY,  and  %MAC  and  %ENDM  commands  (C-Specs»  may  not  exist  within 
a  Data  File,  and  TFS  will  generate  a  fatal  error  if  one  is  encountered. 


EXAMPLES  Of  the  USE  Of  ITS  DATA  FILES 


The  applications  of  TFS  Data  Files,  then,  are  enormous.  With  the  ability 
to  contain  TFS  commands,  the  power  of  a  TFS  Data  File  is  greatly  extended  over 
that  of  conventional  data  files. 

TWo  applications  are  of  particular  interest.  The  first  is  in  creating  a 
Data  File  which  may  be  used  to  provide  a  common  initialization  of  a  TFS  Source 
File.  If  several  TFS  Source  Files  require  the  same  type  of  initialization,  a 
TFS  Data  File  may  be  created  containing  the  proper  statements,  and  it  may  be 
read  by  the  Source  Files  in  an  infinite  loop.  The  Data  File,  of  course,  would 
have  %LEX  as  its  last  word. 

Specifically,  the  following  Illustrates  such  an  application: 

TFS  Source  Pile  TFS  Data  File 


%LOOP  %READ  %ENDL  %LMAR  0  tLLEN  85  tPSON  65 

%REM  continue  source  ISETN  1  %LEX 


In  this  example,  the  loop  in  the  first  line  of  the  TFS  Source  File  is 
executed,  reading  the  words  in  the  TFS  Data  File  one  word  at  a  time.  Each  time 
the  %R3AD  is  executed,  a  line  from  the  data  file  is  read  and  processed.  This 
loop  will  execute  twice,  and,  when  the  %LEX  C-spec  is  encountered,  the 
processing  will  continue  in  the  source  file  on  the  second  line. 
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The  second  application  is  in  processing  mailing  lists.  The  following 
illustrates  such  an  application: 

TPS  Source  File  TPS  Data  Pile 


%OPEN  DATA1  %3EM  Open  Data  File 

%LOOP  %COPY  4  %R£AD 

%CR  %SNDC  Dear  %READ  %BS  , 

IP  Hello.  How  are  you 
today? 

«ASIS 

Sincerely, 

Your  Friend 

%ASIS 

%PAGS  %SNDL 

IP  This  line  is  extra. 

%CLOS 


Mr.  James  Jones 
43  Ocean  Avenue 
Apt.  4 

Sea  Bright,  NJ 
Jim 

Mr.  John  Smith 
29  Queens  Blvd 

Sea  Bright,  NJ 

John 

%LEX 


In  this  example,  the  TFS  Data  File-  is  a  mailing  list,  consisting  of  four 
lines  of  address  and  a  fifth  line  containing  the  person's  first  name.  Note  that 
the  Data  File  ends  with  a  %LEX  C-spec,  and  control  is  transferred  to  the  line 
after  the  line  containing  %ENDL  of  the  Source  File  when  this  is  encountered. 

The  first  line  of  the  Source  Fite  reads  the  four  lines  of  the  address  and 
inserts  them  into  the  output.  The  %CR  on  the  next  line  of  the  Source  File 
terminates  each  line  read,  and  the  %SNDC  terminates  the  copy. 

After  the  address  is  read,  the  word  "Dear"  is  output  at  the  beginning  of 
the  fifth  line  (note  the  last  %CR  before  the  %ENDCI  followed  by  the  name  of  the 
person  from  the  fifth,  tenth,  etc.,  lines  of  the  Data  File.  The  internal 
pointer  is  backed  up  by  the  %BS  C-spec,  and  a  comma  is  placed  immediately  after 
the  inserted  name. 

The  body  of  the  letter  is  then  output,  followed  by  the  page  eject  in  the 
Source  File. 

Here,  then,  are  just  two  examples  of  the  use  of  Data  Files  in  TFS.  As  the 
user  can  see,  the  possibilities  are  enormous. 


Page 
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CHAPTER  5 

Miscellaneous  C-specs,  including  Macros 


The  following  are  other  C-specs  in  TFS: 

II  The  environmental  control  C-specs ,  %SAV  and 
%RES, 

2)  The  pause  C-spec,  %PAUS, 

3)  The  exit  C-specs,  %EXIT,  %STOP,  and  %HALT , 

4)  The  keyboard  input  C-spec,  %KB, 

51  The  comment  C-spec,  %REM, 

6)  The  append  C-spec,  %.APND,  and 

7)  The  Macro  C-specs,  %MAC  and  %ENDM. 


The  %SAV  and  %RES  C-specs  are  used  to  save  and  restore  the  TPS  environment, 
respectively.  The  TFS  environment  consists  of  the  following: 

1)  The  number  of  lines  to  skip  between 

paragraphs, 

2)  The  centering  flags, 

3t  The  automatic  paragraphing  flag, 

4)  The  right  justification  flag,  which  indicates 

if  right  justification  is  turned  on, 

5)  The  current  page  number, 

6)  The  paging  flag,  which  indicates  if  page 

nuntoering  is  currently  turned  on, 

7)  The  indent  and  exdent  counts, 

8)  The  left  margin  setting, 

9)  The  length  of  the  output  line, 

10)  The  underline  flag,  which  tells  if  underlining 

is  engaged, 

11)  The  heading  flag,  which  tells  if  a  heading  is 

currently  set, 

12)  The  footer  flag,  which  tells  if  a  footer  is 

currently  set, 

13)  The  line  spacing,  and 

14)  The  current  value  of  the  number  buffer. 


Whenever  tSAV  is  encountered,  these  values  are  saved  in  a  reserve  buffer. 
Their  values  remain  unchanged.  At  this  time,  the  user  may  change  whichever 
values  he  wishes.  When  he  wishes  to  restore  the  saved  environment,  he  simply 
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enters  the  IRES  command. 


The  IPAUS  C-spec  is  used  to  send  a  message  to  the  user  and  suspend 
operation  of  TPS  until  the  user  responds  by  typing  any  key  on  the  keyboard  of 
the  principal  I/O  device.  It  takes  the  form  of  IPAUS  <text>,  where  <text>  is 
terminated  by  the  end  of  the  current  line.  If  the  user  types  an  <ESC>  after  the 
message  is  displayed,  TPS  will  abort. 


The  %EXIT,  %STOP,  and  IHALT  C-specs  are  used  to  terminate  interpretation  of 
the  TPS  source  immediately.  They  force  a  page  eject  and  then  return  to  the 
operating  system.  They  may  be  used  for  many  reasons,  but  a  very  good  use  of 
these  C-specs  is  to  terminate  infinite  loops  and  the  corresponding  output  when 
reading  a  data  file. 


The  1REM  C-spec  allows  the  user  to  enter  a  remark,  or  comment,  into  the 
file.  The  comment  starts  with  the  first  character  following  the  word  'IREM'  and 
continues  to  the  end  of  the  line  in  the  file.  The  next  line  is  then  interpreted 
normally. 


KEYBOARD  INPUT 


Keyboard  Input  is  a  very  useful  feature  of  TPS  which  is  designed 
specifically  for  application  with  form  letters  or  documents.  Keyboard  Input 
causes  TFS  to  pause  in  its  output  processing  and  allow  the  user  to  type  one  line 
of  text  to  be  inserted  into  the  output  at  the  current  position.  All  of  the  CP/M 
input  line  editor  commands  are  in  effect,  and  processing  continues  only  after 
the  user  hits  the  Return  key. 

The  %KB  C-spec  engages  Keyboard  Input  and  is  of  the  form  '%KB  text'.  Upon 
encountering  this  C-spec,  TFS  prints  the  text  on  the  rest  of  the  line  after  the 
C-spec  (IKS)  on  the  user's  console,  outputs  a  <CR>  <LF>,  types  the  word 
'INPUT:  ',  and  waits  for  the  user  to  type  something.  The  text  typed  by  the  user 
is  then  inserted  into  the  document,  and  ITS  continues  processing. 

The  text  typed  by  the  user,  as  in  all  text  processed  by  TFS,  may  contain 
embedded  commands  (C-specs)  like  IT,  %C,  etc.  Only  the  %ASIS,  %MAC,  %ENDM, 
%COPY,  and  I LOOP  C-specs  may  not  be  placed  in  the  text  typed  by  the  user,  and  a 
TFS  fatal  error  will  result  if  this  is  done. 

For  example,  a  way  to  use  %KB  to  input  the  address  for  a  form  letter  is  — 
%LOGP 

IKS  Input  the  address  and  type  ILEX  when  done 

ICR  IREM  start  a  new  line 

IENDL 
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APPENDING  FILES 


In  some  cases,  the  user  may  wish  to  load  another  file  and  continue 
formatting  in  the  same  environment  as  the  previous  file  (i.e.,  he  may  wish  to 
have  the  same  line  length,  the  same  paragraph  settings,  etc.).  The  %APND  C-spec 
was  created  to  permit  the  user  to  do  this.  This  command  gives  the  TFS  user  the 
additional  flexability  of  producing  a  report  which  spans  over  several  files. 

The  %APND  C-spec  is  of  the  form  '%APND  DiFILENAME. EXT' .  Upon  encountering 
this  C-spec,  TFS  clears  the  local  file  space  and  loads  the  specified  file.  It 
then  continues  formatting  at  the  first  word  of  the  loaded  file.  The  drive 
specification  and  file  extension  are  optional:  if  the  drive  spec  is  omitted,  the 
current  logged-in  disk  is  default,  and  if  the  file  extension  is  omitted,  ".TFS" 
is  the  default. 

All  the  environmental  attributes  of  the  previous  file  are  preserved,  but 
the  macros  need  to  be  redefined.  Hence,  the  %APND  C-spec  easily  allows  the  user 
to  chain  several  files  into  one  formatted  listing. 


MACROS 


Macros  are  essentially  subroutines  placed  within  the  TFS  formatting  file. 
Each  macro  is  of  the  form  of  the  IMAC  C-spec  followed  by  the  name  of  the  macro; 
this  name  must  be  four  characters  or  less  —  any  additional  characters  will  be 
discarded.  The  first  word  following  the  macro  name  is  the  first  word  of  the 
macro.  The  contents  of  the  macro  include  all  words  following  its  name  up  to  and 
including  the  %0JDM  termination  word. 

Macros  are  not  executed  when  they  are  defined.  They  are  executed  only  when 
their  names  are  referenced.  For  example,  if  the  TFS  file  contained: 

%/MAC  TFS  %UL  TFS  %'JL  %3S  ,  %ENDM 
•  •  • 

%TFS  you  see 

the  phrase  'TFS,1  would  only  be  printed  when  the  last  line  was  encountered. 

All  macros  must  be  defined  before  they  are  first  referenced.  TFS  is  a 
one-pass  formatter,  so  the  table  of  macro  names  is  only  formed  as  the  macros  are 
defined. 

The  nesting  of  macros  is  permitted.  Macro  definitions,  however,  may  not  be 
nested,  but  one  macro  may  call  another  macro  which  in  turn  calls  another.  This 
type  of  nesting  is  permitted  up  to  ten  levels  deep.  An  indirect  recursion  is 
not  checked  for  by  TFS,  and  such  a  situation  could  be  disasterous.  Up  to  twenty 
macros  may  be  defined. 

The  best  way  to  discover  exactly  what  macros  can  do  is  to  try  them.  The 
nwcro  facility  of  TFS  is  indeed  very  powerful,  and  it  can  be  of  enormous  value 
in  creating  formatted  text. 
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CHAPTER  6 

TPS  User  and  Error  Messages 


There  are  two  types  of  messages  issued  by  TFS:  (II  User  Messages  and  (2) 
Error  Messages.  This  chapter  identifies  and  describes  the  meaning  of  all  major 
TFS  messages. 


TPS  USER  MESSAGES 


PLEASE  INSERT  NEXT  PAGE 

Insert  the  next  page  into  the  printer;  this  message  -appears  when  the  '/P* 
(PAUSE  after  each  page)  option  is  used.  When  ready,  the  user  types  any 
character  to  continue  or  <ESC>  or  Ctrl-C  to  abort  TFS  and  return  to  the 
operating  system. 


TYPE  ANY  CHAR  WHEN  READY,  <ESC>  OR  CTRL-C  TO  ABORT 

This  appears  when  a  %PAUS  C-spec  is  used.  Again,  the  user  types  any 
character  other  than  <ESC>  or  Ctrl-C  to  continue  and  <ESC>  or  Ctrl-C  to  abort 
TFS  and  return  to  the  operating  system.  This  message  appears  when  TFS  is  first 
engaged  in  order  to  give  the  user  an  opportunity  to  set  the  Top  of  Form  on  the 
printer. 


NEW  PAGE  SETTING  —  PLEASE  SET  TOP  OF  FORM 

A  %LINE  command  was  issued,  resetting  the  page  parameters.  Please  reset 
the  top  of  form  on  the  printer.  Once  top  of  form  is  set,  type  <ESC>  or  Ctrl-C 
to  abort  or  any  other  key  to  continue. 


-H-  TFS  ++  LOAD: 
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TFS  is  in  the  process  of  opening  the  specified  file  as  a  source  text  file. 
This  file  was  specified  either  in  the  TFS  command  line  or  by  an  %APND  command. 


-H-  TFS  ++  OPEN: 

TFS  is  in  the  process  of  loading  the  specified  file  as  a  data  file.  This 
file  was  specified  in  an  %OPEN  C-spec. 


-H-  TFS  ++  DISK  OUTPUT  SELECTED 
FILE  NAME:  filename.DOC 
DISK  OUTPUT  DRIVE  (A/B/C/Dl  ? 

TFS  has  recognized  the  /D  option  and  has  specified  the  output  file.  1116 
user  is  to  select  the  disk  drive  (which  must  NOT  be  removed  during  output 
processing)  to  which  the  output  file  information  will  be  sent. 


LST:  DISPLAY  SET  BY  DEFAULT 

TFS  output  is  to  go  to  the  CP/M  LST:  device. 

CON:  DISPLAY  SELECTED 

TFS  output  is  to  go  to  the  CP/M  CON:  device. 

PAUSE  SELECTED  —  LST:  DISPLAY  SET 

The  /P  (Pause  after  each  page)  option  was  given  In  the  command  line.  TFS 
output  is  to  go  to  the  CP/M  LST:  device. 


INPUT: 

A  %KB  (Keyboard  Input)  C-spec  has  been  encountered.  TFS  is  waiting  for  the 
user  to  type  something  (ending  in  a  <CR>) .  CP /M  input  line  editing  is  in  effect 
«DEL>,  Ctrl-X,  etc.). 


TFS  ERROR  MESSAGES 


$$DATA  FILE  NOT  FOUND 


The  Data  File  named  in  an  %OPEN  C-spec  was  not  found  on  the  Logged-In  or 
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specified  diskette  drive. 


$$DATA  FILE  NOT  OPEN 

A  %READ  was  attempted  vhen  a  Data  File  had  not  been  opened. 


$$EOF  OF  DATA 

An  attempt  was  made  to  read  past  the  end  of  the  opened  Data  File. 
$$INVLD  CMND  IN  KEYBOARD  INPUT  LINE 

One  of  the  restricted  commands  for  the  %KB  C-spec  was  encountered  in  the 
input  line  just  typed.  See  Chapter  5  for  a  list  of  these  commands. 

$$INVLD  OND  IN  DATA  FILE 

One  of  the  restricted  commands  was  encountered  in  the  opened  Data  File. 
See  Chapter  4  for  a  list  of  these  comnands. 

$$LOOP  ERR 

An  %ENDL  or  %ENDC  was  encountered  without  a  proceeding  %LOOP  or  %COPY. 
This  will  also  occur  if  the  %LOOP  or  %COPY  is  in  one  Source  File  and  the  %ENDL 
or  %QIDC  is  in  an  appended  Source  File. 

$$MACRO  RET  ERR 

An  error  has  occurred  in  the  user's  MACRO  call  structure.  An  %ENDM  was 
encountered  without  a  corresponding  %MAC. 


$$FILE  NOT  FOUND 

The  file  referenced  in  an  %APND  C-spec  was  not  found  on  the  Logged-In  or 
specified  diskette  drive. 

$$TAB  ERR 

An  attempt  was  made  to  tab  to  a  column  before  the  current  column  pointer. 


$$ERRDR  —  INVALID  DISK  DRIVE  SPECIFIED 

An  invalid  diskette  drive  specification  (e.g.,  X:t  appears  in  an  %OPEN  or 
%APND  C-spec. 
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$$ERR3R  —  TEXT  BUFFER  OVERFLOW  —  BREAK  UP  SOURCE  FILE 

The  TFS  source  file  is  too  large  to  completely  fit  in  the  TFS  text  file 
buffer.  Break  it  into  two  parts  and  link  these  parts  using  the  %APND  C-spec. 

$$INVLD 

An  error  exists  in  the  TFS  Source  File  after  a  command  which  expects  a 
numeric  constant.  Such  commands  are  %CH,  %TP,  etc. 

$$XDENT  ERR 

A  IPX  was  attempted,  and  the  resulting  starting  location  of  the  Xdented 
Paragraph  was  before  the  first  column  of  the  printer. 
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CHAPTER  7 

A  Sample  TFS  Source  File 


This  chapter  is  designed  to  show  the  user  specifically  what  a  TFS  source 
file  looks  like  and  how  the  various  features  of  TFS  may  be  employed  to  produce  a 
document.  As  the  user  can  see,  the  source  file  under  discussion  is  this  chapter 
itself.  This  first  part  of  this  chapter  is  a  copy  of  the  docunent  after  it  has 
been  formatted,  and  the  last  part  of  this  chapter  is  a  copy  of  the  TFS  source 
file. 


As  the  user  may  note,  three  macros  have  been  defined.  These  are  used  for 
generating  a  numbered  itemized  list.  The  macro  %LIST  initializes  the  list,  the 
macro  %ELST  ends  the  list  mode,  and  the  macro  ILE  allows  the  user  to  enter  an 
element  into  the  list. 

Macros,  as  one  can  see,  provide  a  very  useful  tool  for  abbreviating  the 
amount  of  text  typed  by  the  user.  They  also  display  the  following  advantages  — 

1.  They  can  be  made  quite 

mnemonic  and  logical  to  use. 

2.  They  can  be  used  to  "remember" 

the  structures  of  the  environments  to 

switch  to  and  from. 

3.  They  can  greatly  improve  the 
legibility  of  a  TFS  source  file. 

4.  They  are  basically  very 

flexable  and  useful  in  nature. 


This  chapter  concludes  the  TFS  manual.  As  the  user  can  see,  TFS,  the  Text 
Formatting  System,  is  indeed  a  very  useful,  powerful,  and  flexable  tool  for  text 
formatting,  or  word  processing,  applications. 

The  source  listing  of  this  chapter  follows  — 
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tllen  80  Ipar  5  1  trem  set  line  length  to  80  cols  and  paragraphs  to 
%rem  indent  5  columns  and  skip  1  line  between  each  paragraph 

%mac  list  %lmar  IS  tllen  40  tsetr  0  1  tendm 

trem  define  the  macro  LIST  to  set  the  left  margin  to  ool  15,  the  line 
trem  length  to  40  columns,  and  the  value  of  register  0  to  1 

tmac  elst  tlmar  0  tllen  80  tskip  2  tendm 

trem  define  the  macro  ELST  to  reset  the  left  margin  and  line  length 
trem  and  to  skip  2  lines 

tmac  le  tp  tr  0  tbs  .  tendm 

trem  define  the  macro  LE  to  start  a  new  paragraph,  display  the  value 
trem  in  register  0,  increment  the  value  after  displaying  it,  and 
trem  appending  a  period  immediately  after  the  number 

tch  7  A  Sample  TPS  Source  Pile 
trem  start  a  new  chapter 

tap  trem  engage  automatic  paragraphing 
tskip  2  trem  skip  down  2  lines 

This  chapter  is  designed  to  show  the  user  specifically  what 
a  TFS  source  file  looks  like  and  how  the  various  features  of  TFS  may 
be  employed  to  produce  a  document.  As  the  user  can  see,  the  source  file 
under  discussion  is  this  chapter  itself.  This  first  part  of  this  chapter 
is  a  copy  of  the  document  after  it  has  been  formatted,  and  the  last 
part  of  this  chapter  is  a  copy  of  the  TFS  source  file. 

As  the  user  may  note,  three  macros  have  been  defined.  These 
are  used  for  generating  a  numbered  itemized  list.  The  macro  %%LIST 
initializes  the  list,  the  macro  %%ELST  ends  the  list  mode,  and  the 
macro  %%LE  allows  the  user  to  enter  an  element  into  the  list. 

Macros,  as  one  can  see,  provide  a  very  useful  tool  for 
abbreviating  the  amount  of  text  typed  by  the  user.  They  also  display 
the  following  advantages  — 

%list 

%le  They  can  be  made  quite  mnemonic  and  logical  to  use. 
tie  They  can  be  used  to  "remember"  the  structures  of  the 
environments  to  switch  to  and  from. 

tie  Tney  can  greatly  improve  the  legibility  of  a  TFS  source  file, 
tie  They  are  basically  very  flexable  and  useful  in  nature, 
telst 
tskip  2 

This  chapter  concludes  the  TFS  manual.  As  the  user  can  see, 

TFS,  the  tul  Text  Formatting  System  tul  tbs  ,  is  indeed  a  very  useful, 
powerful,  and  -lexable  tool  for  text  formatting,  or  word  processing, 
applications. 

The  source  listing  of  this  chapter  follows  — 
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CHAPTER  8 

Summary  of  the  TPS  Commands 


The  TFS  Command 


The  general  form  of  the  command  to  invoice  the  Text  Formatting  System  (TFS)  is  — 

TFS  filename.ext  /o 

where  '.ext'  and  '/o'  are  optional.  If  '.ext'  is  omitted,  '.TFS'  is  assumed. 
Valid  options  are  — 

Option  Meaning 

/Sn  Skip  the  specified  number  of  pages 
/V  View  the  output  on  the  user's  console 
/P  fhuse  at  the  end  of  each  page 
/D  Send  output  to  a  disk  file 
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Output  Control 
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Data  File  Manipulation 

CLOS 

OPEN  filename 

READ 

Miscellaneous 

APND  filename 

KB  text 

RES 

ENDM 

MiC  name 

SAV 

EXIT 

PAUS  text 

STOP 

HALT 

REM  text 
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*%PNUM  —  SET  NUM3ER  OF  NEXT  PAGE 
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GENERAL  SUPPORT  SECTION 
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